Improve gtk_container_add docs

Mention that some containers add intermediate children automatically.

diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index b3b1094223e3da9599d70cd6048a466530272568..82fda082a6356d634ffd47a7859c6162c072056f 100644 (file)
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -1520,7 +1520,11 @@ gtk_container_get_border_width (GtkContainer *container)
  * gtk_grid_attach() as an alternative to gtk_container_add() in
  * those cases. A widget may be added to only one container at a time;
  * you can't place the same widget inside two different containers.
- **/
+ *
+ * Note that some containers, such as #GtkScrolledWindow or #GtkListBox,
+ * may add intermediate children between the added widget and the
+ * container.
+ */
 void
 gtk_container_add (GtkContainer *container,
                    GtkWidget    *widget)